Netscape Plug-Ins Developer's Kit/Netscape_Plug-Ins_Developers_Kit.iso/EDITORS/grinder/GRINDER.HQX/grinder_bundle.sea.hqx/HTML Grinder ƒ/Grinder Manual/Grinder Manual

Common Ground | 1995-11-04 | 371.3 KB | 2,275 lines | [APPL/CGSL]

ffffff
ffff33
ff33ff
ff3333
33ffff
33ff33
3333ff
333333
wwwwww
UUUUUU
DDDDDD
""""""
Lucida Bright
HTML Grinder
Intelligent Link Automation
for Webmasters
    Helvetica
To View Next Page:
Choose
 from Page menu
or type
To View Previous Page:
Choose
Previous
 from Page menu
or type
To Print Document:
Choose
Print
 from the File menu
or type
:(Other navigation commands are available in the Page menu)
1994-95 by Michael Herrick/Matterform Media
"HTML Grinder and the Grinder icons
"are trademarks of Matterform Media
http://www.matterform.com/
2http://www.matterform.com/grinder/htmlgrinder.html
4http://www.matterform.com/software/registration.html
[e-mail]
Lucida Bright
Table of Contents
Introduction
)F ................................
)] ................................
.............................
What is the HTML Grinder?
 ................................
)U ................................
Plug-In Tool Approach
)v ................................
)U ................................
..........
    Demo Mode
)< ................................
)U ................................
)U ................................
How to contact Matterform Media
 ................................
........................
1Copyright Information and Distribution Permission
........................
Getting Started
)R ................................
)] ................................
.........................
Grinder Package
)Q ................................
)U ................................
........................
Grinder Requirements
)n ................................
)U ................................
.............
Grinder Limitations
)a ................................
)U ................................
..................
Balloon Help
)A ................................
)U ................................
..............................
~'Loading your documents into the Grinder
 ................................
........
Important Warning
)^ ................................
)U ................................
...................
Select your documents
)q ................................
)U ................................
............
Loading your documents
){ ................................
)U ................................
........
Documents Loaded
)^ ................................
)U ................................
...................
Selecting a wheel to use
)v ................................
)U ................................
..........
The Grinder Wheels
)l ................................
)] ................................
................
Find and Replace
)S ................................
)U ................................
.......................
Glossary
), ................................
)U ................................
)U ................................
......
Replace Tagged Text
)f ................................
)U ................................
................
Appender
)1 ................................
)U ................................
)U ................................
Index Builder
)D ................................
)U ................................
.............................
Date Stamp
)9 ................................
)U ................................
)U ................................
Insert Image Size Tags
)n ................................
)U ................................
.............
Filename Fixer
)I ................................
)U ................................
...........................
    Recreator
)1 ................................
)U ................................
)U ................................
Color Calculator
)Q ................................
)U ................................
........................
Sequential Linker
)V ................................
)U ................................
......................
StretchList
)6 ................................
)U ................................
)U ................................
Preferences
)@ ................................
)] ................................
...............................
Appendix
)7 ................................
)] ................................
)^ ................................
Demo Mode and Serial Numbers
 ................................
...........................
t drag documents onto the Grinder icon
 ................................
.....
(Tricks for selecting icons in the Finder
 ................................
...............
Comment Tags
)L ................................
)U ................................
..........................
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Introduction
What is the HTML Grinder?
Lucida Bright
[The HTML Grinder is not an editor. It is not a WYSIWYG tag converter or a friendly tutorial
6]for those trying to learn the Hypertext Markup Language. It
s not like any other HTML utility
ve ever seen, but once you try it out, you may find you can't live without it.
UThe Grinder was developed to meet the needs of advanced Webmasters who need to manage
6Xsites comprising dozens or hundreds of pages. The Grinder won
t write your pages for you
\the way an editor will, but it will help you maintain them and keep them in order far better
than any mere editor could.
YSay your Web site has been up for a while, and now you
ve changed your email address. Say
6Zthat email address appears on every one of your fifty pages. How is your HTML editor going
^to help? You have to open each text file in turn, make the change, and move on to the next. If
re quick, this will keep you busy for about fifteen minutes.
[The Grinder lets you do it all in a single stroke. You just drag all your HTML documents on
6`the Grinder icon, set up a single search-replace dialog box, and click the start button. All the
Bchanges in all your HTML documents are done in less than a minute.
[Or say you want to make a table of contents to your site so folks can choose a page from an
6Walphabetical list. Or have you ever wanted to put a date on the bottom of each page? Or
Ymaybe make a chain of pages, with next and previous links leading the reader from page to
page.
YAn editor can put these kinds of elements on your pages. But you still have to do all the
6Xclicking and typing. The Grinder can put these elements on your pages automatically. You
Yjust drag the files you want onto the Grinder icon, set a few parameters, and the Grinder
handle starts to spin!
Plug-In Tool Approach
^The Grinder doesn
t do anything by itself. It requires special plug-in tools, called
wheels,
6'to make changes to your HTML documents.
QEach wheel is a miniature program that performs a specific task. One wheel does a
6^find/replace, another wheel creates a table of contents, another puts a date stamp on all your
Zpages, and so forth. This modular approach makes it possible to expand the capabilities of
Vthe Grinder by releasing new wheels. And it lets you save money by purchasing only the
Zwheels you find the most useful. A discount is available if you purchase all the wheels at
once.
ffffff
ffff33
ff33ff
ff3333
33ffff
33ff33
3333ff
333333
wwwwww
UUUUUU
DDDDDD
""""""
QAnd what are those icons supposed to be? Why, they
re the
wheels,
 the kind that
6Vplug into those industrial-grade food grinders for grating cheese. Watch your fingers!
    Demo Mode
VThe Grinder program and one of the wheels, the
Find and Replace
 wheel, are free. You
66may use this software forever at absolutely no charge.
YThe other Grinder wheels ship in
demo mode
 which allows you to try them out for a short
6^time before purchasing. The wheels are fully functional, but they expire after a few weeks and
Fyou need to register them with a serial number to continue using them.
TYou can purchase the serial numbers directly from the Matterform Media web site (see
6[below). You can buy numbers for all the wheels, or just for the ones you use the most. Once
Vyou receive your numbers and enter them into the software, you will be able to use the
5Grinder wheels indefinitely and without interruption.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Lucida Bright
Important:
ODo not open any of the wheels until you are ready to evaluate it. If you open a
6_wheel for a quick look, then close it and don
t come back to it for a month, you will find that
Zit has expired before you even had a chance to review it. Downloading a new wheel will not
it will be expired too.
Also Important:
-When you receive your serial numbers, install
6Sthem right away. They will expire in a few days if you do not use them soon enough.
RWhen a wheel is opened in Demo Mode, it prompts you to enter a serial number or to
continue in Demo Mode. See the
Appendix
)6. for more information about serial numbers and
Demo Mode.
How to contact Matterform Media
SInformation about the HTML Grinder, Matterform Media, and other Matterform products
6Xcan be viewed at the Matterform Web site. You can download the Grinder directly from the
Xsite, and also purchase serial numbers for your favorite wheels. Use the following URLs:
Matterform site:
Courier
http://www.matterform.com/
HTML Grinder Info:
)p2http://www.matterform.com/grinder/htmlgrinder.html
Purchase Serial #s:
)l4http://www.matterform.com/software/registration.html
Email:
[e-mail]
?\We take orders only through the Web site. However, if you fill out the order form, but don
6[want to send your credit card number over the Internet, there is a place for you to type in
Wyour phone number so we can call you for your credit card information. You can also fax
Pcredit card info, or send a check or money order. Email us for more information.
WRemember, the Grinder is expandable. If you have a task that you would like to automate
6[with a new Grinder wheel, please write to us. Your ideas help us make the Grinder even more
Rpowerful. We would also be very interested to hear about any unusual uses you have
 discovered for the HTML Grinder.
1Copyright Information and Distribution Permission
UThe HTML Grinder is common law copyright 1994-95 by Michael Herrick/Matterform Media.
6.Copyright protection applies to the following:
$The HTML Grinder application program
All the plug-in wheels
The Read Me file
This manual
?=Distributing this software without permission is prohibited.
Permission is hereby granted
to distribute the HTML Grinder
4 as long as all of the following conditions are met:
SThe entire package (application, wheels, readme file, and manual) must be included.
5No portion of the package may be modified or altered.
1The wheels must be distributed in Demo Mode only.
?JAll the Grinder wheels (except the Find and Replace wheel, which is free)
revert to demo
U and require new serial numbers as soon as they are copied to another Macintosh. This
6\allows you to share the Grinder with your friends and let them try it out for a few weeks in
UDemo Mode without committing software piracy. Thank you for respecting copyright law.
[If you want to include the Grinder in a shareware software collection
either online, floppy
6Rdisks, CD-ROM or other media
please write for permission and for more information.
TPermission will almost certainly be granted, but we just want to know ahead of time.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Getting Started
Grinder Package
Lucida Bright
SWhen you download the HTML Grinder, you receive a compressed bin-hex document which
6:uncompresses into a folder containing the following icons:
HTML Grinder Application
ffffff
ffff33
ff33ff
ff3333
33ffff
33ff33
3333ff
333333
wwwwww
UUUUUU
DDDDDD
""""""
MThe HTML Grinder is the main application program. It contains the bulk of the
6Rprogramming and it coordinates the various plug-in wheels that you have installed.
Grinder Tools
ffffff
ffff33
ff33ff
ff3333
33ffff
33ff33
3333ff
333333
wwwwww
UUUUUU
DDDDDD
""""""
SThe Grinder Tools folder contains all the Grinder plug-in wheels. The Grinder needs
6Qto be able to locate this folder on your hard drive, so do not move or rename it.
Other items
VA ReadMe file and this manual are also included. If you wish to distribute the Grinder
6Qaccording to the terms outlined above, these are the four items you must include.
Grinder Requirements
Rs >D
RJBE)    bR
E)    BR
JRJRE)    BR
^    HIB
Q    HI3
<g60I
AThe Grinder requires System 7.0 or later and a 68030 processor or
6Gfaster. You should allocate at least 1500K of memory to the Grinder and
the more the merrier.
$To set the memory allocation, click
 on the Grinder icon and
choose
Get Info...
)65 from the File menu. A window appears with fields for
6Hthe memory allocation in the lower-right corner. Make sure the preferred
size is at least 1500K.
Grinder Limitations
=The Grinder can work with pieces of text 30K or smaller. This
6^limitation applies to the text fields in the Grinder windows and to the HTML files you want to
agrind. If you try to grind a document larger than 30K, you will receive an error. No fix for this
-limitation is anticipated in the near future.
UThis limitation also has ramifications for the number of documents you can grind at a
6Zsingle pass. Since the pathname for each document you drag onto the Grinder is stored in a
[single text field, a large group of documents can max out the 30K limitation. The practical
]limit to the number of files that can be ground in a single pass is somewhere around three to
[four hundred. If you need to grind more documents than that, you will need to grind them in
two groups.
Balloon Help
YBalloon Help is supported throughout the HTML Grinder and all of the plug-in wheels. When
6_you are first learning to use the Grinder, you may find it helpful to turn on Balloon Help from
X menu and point at all the buttons, text fields and other elements in the wheel windows.
?^A simple help screen is also available for the Grinder. You can see this screen at any time by
clicking the
)JA in the lower-left corner of any wheel window. You can also type
? or press the
6!HELP key on an extended keyboard.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
6'Loading your documents into the Grinder
Important Warning
Lucida Bright
SThe Grinder makes extensive and permanent alterations to large numbers of your HTML
6Vdocuments at once. There is no way to undo the modifications performed by the Grinder.
VPlease exercise caution and make sure you have recent backups of the documents you are
about to grind.
Select your documents
YSelect the documents you want to grind by highlighting their icons in the Finder. You can
6`shift-click on each icon in turn, or drag a selection rectangle to select the icons you want. Be
sure to select
J those documents you want to grind. In most cases, these will be only HTML
6>text documents. For advanced tips on selecting files, see the
{    Appendix.
Loading your documents
~~~~~~
}}}}}}
||||||
{{{{{{
zzzzzz
yyyyyy
xxxxxx
wwwwww
vvvvvv
uuuuuu
tttttt
ssssss
rrrrrr
qqqqqq
pppppp
oooooo
nnnnnn
mmmmmm
llllll
kkkkkk
jjjjjj
iiiiii
hhhhhh
gggggg
ffffff
eeeeee
dddddd
cccccc
bbbbbb
aaaaaa
``````
______
^^^^^^
]]]]]]
\\\\\\
[[[[[[
ZZZZZZ
YYYYYY
XXXXXX
WWWWWW
VVVVVV
UUUUUU
TTTTTT
SSSSSS
RRRRRR
QQQQQQ
PPPPPP
OOOOOO
NNNNNN
MMMMMM
LLLLLL
KKKKKK
JJJJJJ
IIIIII
HHHHHH
GGGGGG
FFFFFF
EEEEEE
DDDDDD
CCCCCC
BBBBBB
AAAAAA
@@@@@@
??????
>>>>>>
======
<<<<<<
;;;;;;
::::::
999999
888888
777777
666666
555555
444444
333333
222222
111111
000000
//////
......
------
,,,,,,
++++++
******
))))))
((((((
''''''
&&&&&&
%%%%%%
$$$$$$
######
""""""
!!!!!!


#&)((%!
&++-0
!++/5
%+/7;
(-6;<
$2:<?
#5=AFJ
09CHH
%5@BDG
2<@EI
JHD?;2
-7@GHHGHFFC9*
#2<BB
.9=AHJJIE@>7)
FF;1!
+7@BDG
-7@HH
FFB9.
HA>8$
FCC=2"
HIH@8/
    JJF@=6-
!/:=AHIJIFFD=7,
H    JJF?;6(
+5=BBFJJHDDE?6(
0:>CHIHHJJ
#3;BFEFKJJ
&3;@CJ
.8ACBGI
.9=AIJ
!29BFD
$0;>A
JJDDE@;4$
HHJHA?<3+
JJFDDC:7-!
IIHIJD=?
HHIJJDFH
DGJJHHJH
+3=?BHIHGIJH
%2;@DDCFJIJ
<;60'
"18=>BHGFI
D@:3-$
-7;@DADH
B==87.%
+27<>DH
EF?=964(
GJIEKJHFIE>
JFFJJGKIFD
800-&!
BGJIHKIFH
;7821.'!
>FJEHJIFI
;><7720,'%
259==ED>FH
A<@@9<<67
.+*(&$
%+659==DF
6A?BA=A>9=
/-/)(*&!!
#,/99=@
CCD@@C@?@@=@
wutrr
5572030--,+(
!*007
CB=AA@@A@??
vtsrqo
95474042.0
(()&%$""#
;<@@=?@
usrqpon
:779737516
_]\[Z
++/*'*)''
7:?;:?@;>>
tsrqpomm
:99878646
^\\ZZX
/1-+/+)-
;;9<<
trrpo
-889877566
^][ZYXW
1/./-,/
IHFEC
B&(,1225577
9689677466
\\ZZXWUU
1/0-..
HFEDCB
86543
!$&+.-1
86377257346
\[ZYW
0/0/..
GEECCA@
765321
1042024/14
/02-/0--/
FEDCB@?>
654311/
/0+-/++.
EECBA
543210/"
 "#%)%&
+(+,((+
$&$$%$#
*Now just point the mouse at any one of the
6&highlighted documents, press the mouse
*button and drag all the documents onto the
#Grinder icon. When the Grinder icon
'highlights, release the mouse button to
 the documents into the Grinder.
,The Grinder application will launch. After a
6*few seconds, you will see the HTML Grinder
(window. A thermometer window will appear
&as the Grinder loads the documents you
dragged onto the Grinder icon.
Documents Loaded
@c038
)JBH
)JBH
)JBH
)JBH
)JBH
)JBH
)JBH
)JBH
)JBH
)JBH
)JBH
)JBH
)JBH
0332d*
0330p
3    03?303308*
03030330
3    0313 332L*
6When this is finished, a soft chime will sound and the
64complete pathnames of every document you loaded will
appear in the
HTML documents to grind
 field. You can
69now use one of the plug-in wheels to make changes to this
group of documents.
0If you want to work on a different group of HTML
68documents, just drag a different group of documents onto
the Grinder icon.
5More information about this window is available under
Preferences
)A' section, below. If you have difficulty
6-dragging documents onto the Grinder, see the
Appendix
for assistance.
Selecting a wheel to use
SOnce you have a group of documents loaded into the Grinder, you can open a wheel to
6 make changes to those documents.
;To use any wheel, just select its name from the Tools menu.
 The wheel window will open on
6Qyour screen. You can return to the HTML Grinder window and see the list of loaded
documents by choosing
Preferences
)A6 from the Tools menu. If you drag a group of documents
6Xonto the Grinder icon in the Finder when a wheel window is open, the Grinder window will
:not appear, but the documents will load in the background.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
The Grinder Wheels
Lucida Bright
VThis section describes and gives instructions for each of the wheels included with the
6YGrinder. This is where the real work gets done! To use the wheels, you should know how to
Kdrag documents onto the Grinder icon, as described in the previous section.
    Demo Mode
WWhen any wheel besides the
Find and Replace
 wheel opens, it displays the registration
6 dialog box. For now, just click
    Demo Mode
)C1 to continue. Later on, if you decide to purchase
6.serial numbers for any of the wheels, see the
Appendix
 for more information.
Find and Replace
330#33
`|<|><
<f>f><
?The Find and Replace wheel is free. Even if you do not purchase
6<serial numbers for any of the other wheels, you can use this
wheel at no charge.
5The Find and Replace wheel works the way any Find and
62Replace command works in most word processors. The
Ddifference is that this wheel will search at a single stroke all the
?documents you drag onto the Grinder icon. You only need to type
2the phrases into the fields once and then hit the
Find & Replace
button.
Glossary
s38p|
c00f1
c0<f1
33 f1
32`f1
8The Glossary wheel is an enhanced Find and Replace wheel
68that lets you make multiple changes in your documents at
once.
Creating glossary entries
;You use the Glossary wheel by setting up glossary
entries
64or find/replace settings. To create an entry, click
G    New Entry
or type
5N. A blank line will be highlighted in the scrollable
6?list of glossary entries and two new fields will appear beneath
    the list.
In the field
Replace this glossary text,
 type in the text you
68wish to search for in your HTML documents. In the field
this HTML code,
)\, type in the text you want to insert in your
6-HTML documents in place of the glossary text.
UThe glossary text will now be listed as an entry in the scrolling list. If you click
Replace
Glossary Text
)MQ at this point, this wheel will function exactly like the Find and Replace wheel.
?ZBut the real point is that now you can set up a second, third, and fourth entry
as many as
you like. Just click the
    New Entry
)<9 button and fill out the fields to add new entries to the
6 scrollable list. When you click
Replace Glossary Text,
& the Grinder will go through each HTML
60document in turn and perform a find and replace
for each one
 of your glossary entries.
Removing and changing entries
ZYou can remove glossary entries just by clicking on them in the list and then clicking the
Delete Entry
)EP button. You will be asked to confirm your decision. And you can edit entries by
6]clicking on them in the list, and then changing the text that appears in the find and replace
fields.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Replace Tagged Text
"DC$H
"DB$H
"DC$H
"DB$H
@dC2
@DB"
"|B$@
@DB"
@DB"
@DB"
"|B$@
2D2"
Lucida Bright
9Replace Tagged Text is a specialized Search/Replace tool.
It lets you search for
% strings of text (called tags), throw
6<out all the text that lies between them, and replace it with
    new text.
Tagging text in your pages
9In order to use this wheel, you need to design your pages
6;with this strategy in mind. There will be certain chunks of
6text in your pages that you will want to change fairly
9frequently. You can
 these chunks so that the Tagged
 Text wheel can find them easily.
<To tag a chunk of text, place one non-displaying comment tag
 before it and another
6_(different) comment after it. For a chunk of text you want to identify as a
footer
, you would
tag it as follows:
Courier
<!--footer-->
Your text and HTML code here...
<!--end of footer-->
Replacing the tagged text
0In the Tagged Text wheel, you would now specify
<!--footer-->
 as the beginning tag and
<!--end of footer-->
)~B as the end tag. Then type or paste into the large scrolling field
6Qwhatever text you want you want to insert between those two tags. When you click
Replace
Tagged Text,
)IL the wheel will go through each one of your documents, find the text between
<!--footer-->
 and
<!--end of footer-->
)y1 tags and replace it with the text you typed into
the large scrolling field.
Appender
c03#2f
c0?30f
c0030f
c0132f
f||<|>
f||<f>
4The Appender wheel lets you insert text at specified
6%locations in all your HTML documents.
:The first field is the large scrolling field where you can
68type or paste the text you want to insert in each one of
your HTML documents.
4Under the large field is a popup menu which controls
66where the text will be appended in the HTML documents.
There are four choices:
At beginning of document.
 Appends the text at the
U4beginning of the document, before all the other text
in the document.
At end of document.
)tA Appends the text at the end of the document, after all the other
text in the document.
Before text.
)@L Appends the text before the first instance in each document of the text you
U7type in the small field to the right of the popup menu.
After text.
):K Appends the text after the first instance in each document of the text you
U7type in the small field to the right of the popup menu.
?\The Before Text and After Text options are especially powerful. If you want to place text at
6Lthe beginning of each page, you will probably want to append text after the
</title>
6+* See Appendix for more about comment tags.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Courier
<body>
Lucida Bright
)(T) tag. If you want to append some text at the end of each page, you should not place
60the text at the end of the entire document, but
before
 the
</body>
 tag (if you use that tag).
?/When you make all the settings, just click the
Append Text
 button.
Index Builder
    P(30
00fbf`
00f<f`
GIndex Builder is a quick and painless way to create those long lists of
6@links and tables of contents that are so common in Web sites. It
Hautomatically puts a list on one page with automatically generated links
 to a group of destination pages.
GTo use this wheel, select your destination pages (that is, the group of
6Hpages for which you want to create a linked list) and drag them onto the
Grinder icon. Then choose
Index Builder
 from the Tools menu.
Click
Select Index File...
)f. This will display a standard Open dialog box.
6HSelect the HTML document on which you want the list to appear with links
Kto all your destination documents. The name of the file appears in the text
field underneath.
.There are two other options to set. Check the
Alphabetize
 box if you want the links
6-arranged in alphabetical order. And from the
Format
)'" popup menu, you can choose among:
Plain.
. Puts each link on its own line, separated by
 tags.
Ordered list.
)E# Creates a numbered list using the
 tag.
Unordered list.
)S# Creates a bulleted list using the
 tag.
When you click
Build Index,
)B? the wheel will create a link for each one of the documents you
6/dragged onto the Grinder icon. It will use the
<title>
).) of each page for the link text, and will
build the
M tags and an appropriate link pathname. Then the wheel will arrange the links
6Ufor each document, alphabetize them if you specified, and list them in the format you
^specified. Finally, the wheel will automatically insert the HTML code for the linked list onto
)the page you specified as the index file.
>Example of the HTML code created for an unordered linked index
<!--index-->
-<li><a href="../folder/file1.html">Page 1</a>
-<li><a href="../folder/file2.html">Page 2</a>
-<li><a href="../folder/file3.html">Page 3</a>
</ul>
<!--end of index-->
?ZThe first time you add an index to a file, it will be appended to the end of the document,
6[after all the other text in the document. However, the index will be wrapped inside two non
displaying comment tags
<!--index-->
and
  <!--end of index-->
?YThe next time you add an index to this file, the wheel will search for these comment tags
6Y(even if you have moved them), throw out the index that lies between them, and insert the
$new index in its place. Pretty cool!
* See Appendix for more about comment tags.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Date Stamp
Lucida Bright
WThe Date Stamp wheel does something you
ve always wanted. Sticks the last modified date
on all your documents.
DA@JP
DA@JR
@PA%)$R
Ng8;y
7It pulls this date directly from the last modified date
69recorded by the System for each of your documents. And it
7gives you a number of options for how that date will be
.formatted. In the middle of the window is the
Date Format
66popup menu. There are three choices. When you select a
2new format, a preview appears just below the popup
menu:
Long.
 Monday, September 18, 1995
Short.
 9/18/95
Abbreviated.
 Mon, Sep 18, 1995
?6(These formats may appear slightly different depending
on the settings of your
Date and Time
 control panel.)
?4You can also wrap the date in text of your choosing.
67There are fields which let you specify what text should
come
Before
)#$ the date and what text should come
After
% the date. The example illustrated on
6%this page would produce HTML text of:
Courier
!<font size="-2">Last modified on:
)<b>Monday, September 18, 1995.</b></font>
?'which would appear in a Web browser as:
Last modified on
Monday, September 18, 1995.
You can modify the
Before
 and
After
5 text to add any HTML code, text or images along with
the date of each document.
Finally, the
Insert
) F popup menu controls where in the documents the date will be inserted.
6*This popup menu operates exactly like the
Append
),! popup menu in the Appender tool.
?TWhen you insert a date stamp for the first time, the HTML code is wrapped in the non
displaying comment tags
<!--date stamp-->
and
  <!--end of date stamp-->
?VThe next time you insert a date stamp on a page, the wheel ignores the setting of the
Insert
6\popup menu. Instead, it finds these comment tags, throws out the old date stamp, and inserts
the new one in its place.
YKeep in mind that when you add the last modified date to each of your documents, you will
modify and thereby
change
)&@ the last modified dates of each document. It
s best to run this
wheel as rarely as possible.
* See Appendix for more about comment tags.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Insert Image Size Tags
Lucida Bright
s that for an interface? One button! But what the heck does this thing
?WThe best way to insert an inlined GIF image is to include the (Netscape only) width and
6?height parameters in your image size tags. They look like this:
Courier
<img
width=100 height=34
 src="image.gif">
?YThe beauty of these tags is that they let the browser software know how big your pictures
6[are right away. That way, the browser can completely lay out the text before it even starts
[downloading the pictures. The page appears immediately with properly sized black spaces for
_the graphics, which gradually fill in. If you don
t insert these tags, the text layout halts at
Aevery graphic and your page seems to take much longer to display.
WUnfortunately, putting those width and height tags in is a royal pain. You have to keep
6[opening up a graphics editor to refer to the pixel dimensions of the image, and then switch
^back to your editor to type the numbers in. The Insert Image Size Tags wheel will insert these
*width and height parameters automatically.
fdff`p
b33 ?
@c32`?
!)IJI
I)JBe
!    IJI
I)zB%
    !)IJI
(RI    JBPR
I)BB%
R`(N)
$$)H)!JB
)@))J
AI)J@
:AI)z@
JAI)B@
:AI)1
$)H$(
%%) AJ
!)H%!
) IH@
)I    `P
$ Q(A    BB
323308`f`1
4You just write your pages and include the image tags
without
)(4 the size parameters. Write all your pages this way.
69Then, when you're done, drag them all on the Grinder, run
:this wheel, and go get a cup of coffee. When you get back,
7the wheel will have calculated the pixel dimensions for
;every picture and inserted the size parameters into each of
$the image tags on all of your pages.
[If the wheel encounters an image tag which already uses the width and height parameters, it
6]will be skipped. Keep in mind that the width and height parameters are functional only in the
_Netscape browser (but they are not less valuable for that). Finally, this wheel is incompatible
Fwith virtual memory; be sure to shut it off before running this wheel.
Filename Fixer
0f<|<
Fff``
>ff`x
0f<f>fc
IBHBB
RBHIJP
)IBH
NB&q9
"`)09
A,    `R
)/I?'
A(    BR
23&`ff1
& fF1
5Filename Fixer is a handy tool for many purposes (not
66just HTML!). Rather than changing the contents of your
documents, it changes their
titles
 with a simple
Search/Replace interface.
8Just fill out the search field and the replace field and
then click
Change Filenames.
 The wheel can change the
6:title of any kind of document: HTML files, GIF files, MPEG
6files, Microsoft Word files
whatever you drag onto the
4Grinder icon. However, it cannot change the names of
folders.
Watch your fingers
You should
always
)$F have backups of the files you are about to grind. Backups are all the
6Xmore important with this wheel, as some people have reported corrupted files immediately
0after running Filename Fixer. Please be careful.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
6    Recreator
Lucida Bright
]The Recreator doesn
t affect the contents of your files. It is designed to quickly change the
Creator Codes
)K0 of your files before you begin working on them.
About creator codes
YEvery Macintosh file has a creator code. It is a four character code embedded in the file
6Nwhich tells your Macintosh what program to use when you double-click the file.
^Since so many different kinds of programs can create text files, a text file could have any of
6\a number of different creator codes. One text file could have a Microsoft Word creator code,
Pwhich gives it a Microsoft Word document icon and which opens the Microsoft Word
Yapplication when you double-click it. Another might have a SimpleText creator code, which
Wgives it a SimpleText document icon and which opens the SimpleText application when you
double-click it.
[Of course, you can open a text file in any program that supports text files by dragging the
6Yfile onto the program icon or by opening the document from within the program itself. But
`when you double-click on the file, it will open in whatever program created it and gave the file
$its creator code in the first place.
When to use this wheel
_This wheel lets you change those creator codes so that your text files will open in a different
6#program when you double-click them.
XThis is useful when you have a number of documents that were created in one program (say
6ZSimpleText) which you want to edit in another program (say BBEdit). Of course you can load
Ythem into BBEdit by dragging them onto the BBEdit program icon. But every time you simply
Xdouble-click the file
which is the most natural way to open it
it stubbornly opens up in
SimpleText. Annoying!
How to use this wheel
YJust drag all the files whose creator codes you want to change onto the Grinder icon. You
6Ycan drag any kind of file
text, graphics, whatever. Then open the Recreator wheel window.
)IBH!$
,HI,    JR
$,HK    I
(BI(    JP
3006xx
y33008
C13 10
8There is only one setting to make. Type the creator code
you want into the
New Creator Code
 field. When you click
Change Creator Codes,
 all the documents you dragged
69onto the Grinder will be transformed to the code you type
in this box.
7Since it isn
t always easy to remember the creator code
6<for particular applications, there is a special shortcut. If
you click
Same As...
):$ you will get a standard Open dialog
6[box. Just select a document that was created by the application whose creator code you want
Gto switch your documents to. It
s creator code will then appear in the
New Creator Code
 field.
NOTE:
)!V After you run this wheel, you will need to close and reopen the folder which contains
6Pthe transformed documents before your Macintosh will associate them with the new
application.
Watch your fingers
You should
always
)$F have backups of the files you are about to grind. Backups are all the
6Xmore important with this wheel, as some people have reported corrupted files immediately
+after running Recreator. Please be careful.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Color Calculator
HHJRBI
)JP    ,    J    )!!J
HJJRRH
    (    HI)!)J
I!!JC
BJP`I    &I:@
I    !IJ@
bc801
)    BA%!$%)    I@
%%)    I@
n&pg8
H)/ t
    @AH$
Lucida Bright
:Most browser programs display Web pages as black text on a
66light gray background. The Netscape browser recognizes
<special tags which let the Web designer customize the colors
=of the background and the text. Writing these tags are fairly
4easy. Figuring out the arcane hexadecimal codes that
5represent the colors is not. If you want a light blue
background, should you use
Courier
9CEF93
B4DF0F
?:The Color Calculator shields you from these codes and lets
64you choose your colors more intuitively. Just click
Color...
)'T to display the standard color wheel. Click the color you want on the wheel. You can
6\lighten or darken the color by using the scroll bar on the right side of the window. You can
Talso fine-tune your color with the HSB or RGB fields on the left side of the window.
~~~~~~
}}}}}}
||||||
{{{{{{
zzzzzz
yyyyyy
xxxxxx
wwwwww
vvvvvv
uuuuuu
tttttt
ssssss
rrrrrr@
oooooo
nnnnnn
mmmmmm
llllll
kkkkkk
jjjjjj
iiiiii
hhhhhh
gggggg
ffffff
eeeeee
dddddd
cccccc@
______
^^^^^^
]]]]]]
\\\\\\
[[[[[[
ZZZZZZ
YYYYYY
XXXXXX
WWWWWW
VVVVVV
UUUUUU
TTTTTT
SSSSSS@
OOOOOO
NNNNNN
MMMMMM
LLLLLL
KKKKKK
JJJJJJ
IIIIII
HHHHHH
GGGGGG
FFFFFF
EEEEEE
DDDDDD
CCCCCC@
??????
>>>>>>
======
<<<<<<
;;;;;;
::::::
999999
888888
777777
666666
555555
444444
333333@
//////
......
------
,,,,,,
++++++
******
))))))
((((((
''''''
&&&&&&
%%%%%%
$$$$$$
######@

o<NoNo^
o@NoNoNo^
oDNoNoNoNoN
oHNoNoNoNoNo^
oLNoNoNoNoNoNoNo^
oPNoNoNoNoNoNoNoN
oRNoNoNoNoNoNoNoNo^
oVNoNoNoNoNoNoNoNoNoNo^
oXNoNoNoNoNoNoNoNoNoNoN
o\NoNoNoNoNoNoNoNoNoNoNoN
o^NoNoNoNoNoNoNoNoNoNoNoNo^
obNoNoNoNoNoNoNoNoNoNoNoNoN
_dooNoNoNoNoNoNoNoNoNoNoNoNoNoN
_f>_NoNoNoNoNoNoNoNoNoNoNoNoNoNo^
_h>_>_NoNoNoNoNoNoNoNoNoNoNoNoNoN
_j>_>_>_NoNoNoNoNoNoNoNoNoNoNoNoNoN
_/>_>_>_>_NoNoNoNoNoNoNoNoNoNoNoNoNo^
_)>_>_>_>_>oNoNoNoNoNoNoNoNoNoNoNoNoN
_'>_>_>_>_>_>oNoNoNoNoNoNoNoNoNoNoNoNoN
_%>_>_>_>_>_>_>oNoNoNoNoNoNoNoNoNoNoNoNo
_#>_>_>_>_>_>_>_>oNoNoNoNoNoNoNoNoNoNo
_!>_>_>_>_>_>_>_>oNoNoNoNoNoNoNoNoNo
>_>_>_>_>_>_>_>_>oNoNoNoNoNoNoNo
>_>_>_>_>_>_>_>_>_NoNoNoNoNoNoNo
>_>_>_>_>_>_>_>_>_>_NoNoNoNoNo
>_>_>_>_>_>_>_>_>_>_>_NoNoNoNo
>_>_>_>_>_>_>_>_>_>_>_>_NoNoNo
>_>_>_>_>_>_>_>_>_>_>_>_>_NoNo
>_>_>_>_>_>_>_>_>_>_>_>_>_>_No
>_>_>_>_>_>_>_>_>_>_>_>_>_>o
>_>_>_>_>_>_>_>_>_>_>_>_>_
>_>_>_>_>_>_>_>_>_>_>_>_>_
>_>_>_>_>_>_>_>_>_>_>_>_>_
>_>_>_>_>_>_>_>_>_>_>_>_>_
._>_>_>_>_>_>_>_>_>_>_>_
.O._>_>_>_>_>_>_>_>_>_>_>_
.O.O.O>_>_>_>_>_>_>_>_>_>_
.O.O.O.O._>_>_>_>_>_>_>_>_
.O.O.O.O.O>_>_>_>_>_>_>_
.O.O.O.O.O.O>_>_>_>_>_>_
.O.O.O.O.O.O.O._>_>_>_>_
.O.O.O.O.O.O.O.O.O>_>_>_
.O.O.O.O.O.O.O.O.O._>_
.O.O.O.O.O.O.O.O.O.O._>_
.O.O.O.O.O.O.O.O.O.O.O.O
.O.O.O.O.O.O.O.O.O.O.O
.O.O.O.O.O.O.O.O.O.O.O
.O.O.O.O.O.O.O.O.O.O.O.O
.O.O.O.O.O.O.O.O.O.O.O
.O.O.O.O.O.O.O.O.O.O.O
.O.O.O.O.O.O.O.O.O.O.O
.O.O.O.O.O.O.O.O.O.O.O
.O.O.O.O.O.O.O.O.O.O.O
.O.O.O.O.O.O.O.O.O.O.O
.O.O.O.O.O.O.O.O.O.O.O
.O.O.O.O.O.O.O.O.O.O.O
.O.O.O.O.O.O.O.O.O.O
.O.O.O.O.O.O.O.O.O.O.O
.O.O.O.O.O.O.O.O.O.O.O
?.O.O.O.O.O.O.O.O.O
?.O.O.O.O.O.O.O
O.O.O.O
.Once you have selected your color, just click
6:wheel will calculate the color code and  insert it in the
Color Triplet
)I, field. Now you can just copy this code into
6-the appropriate place in your HTML documents.
Note:
0The Color Calculator wheel is unusual in that it
65does not modify your HTML documents automatically. It
2completely ignores any documents that you may have
7dragged onto the Grinder icon. All the Color Calculator
<does is compute the code for the color you pick. After that,
s up to you to insert that code in the proper place of your HTML document.
Where to put the color codes
.The color codes are used as parameters to the
<body>
 tag. The
<body>
 tag is somewhat
6Voptional, and many people do not use it until they want to use one of the custom color
parameters. The
<body>
)'B tag surrounds the contents of your HTML document in the following
fashion:
Anatomy of an HTML Document
<html><head>
+<title>Title of the Document</title></head>
<body bgcolor="#9CEF93">
 Contents of the document here...
</body></html>
?>You can insert any or all of five different parameters in the
<body>
 tag:
bgcolor="#XXXXXX"
Sets the background color
text="#XXXXXX"
Sets the color of the text
link="#XXXXXX"
%Sets the color of the hypertext links
vlink="#XXXXXX"
-Sets the color of the visited hypertext links
alink="#XXXXXX"
%Sets the flash color you see when you
click on hypertext links
?QYou may want to visit the Netscape Web site at http://home.netscape.com/ for more
61information about the usage of custom color tags.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Sequential Linker
Lucida Bright
WMany Web designers often find themselves facing the task of connecting a group of pages
6]into a sequential chain, with links on each page that point to the next and previous pages in
Xthe chain. These chains require a great deal of work, especially when they have to be re
organized.
[The Sequential Linker makes this a task of one minute. It automatically connects pages in a
6]sequential chain with links that lead from page to page, forward and backward. It even allows
3you to add a link up to a
Table of Contents
 page.
+Loading your documents in the correct order
]To use this wheel, the first step is to select all the HTML documents in the chain. The order
6Zin which you select the documents determines the order in which they will be linked in the
]chain. The best method is to click on the first document in the chain, and then hold down the
Sshift key and click on the next document, the next document and so on until all the
Mdocuments are selected. Then let go of the shift key, point the mouse at the
first
     document
6>selected, and then drag the whole group onto the Grinder icon.
Settings
ZAfter you have loaded the documents, open the Sequential Linker if it is not already open,
6 and make the following settings:
c#00ff
c300fg
c300fg
c300ff
8x||x
0>ffc
c fFff
b``ffb
AII%
H%$RH
JB    A%$
"A    HI
Choose a Table of Contents Page
The first item is the checkbox
 Use Table of
Contents Page.
)S$ If you leave this button unchecked,
61the wheel will add only two links to each of your
3pages, one to the previous page and one to the next
4page. If you check this button, the wheel will add a
6third link to your pages, a link to a page outside the
3chain which can serve as a linked table of contents
1to all the documents in the chain (you can easily
6create the contents page with the Index Builder tool).
3If you are using a table of contents page, you need
6)to specify which page to use by clicking
Choose
Contents Page...
)XJ A standard open dialog box will appear with which you can select the HTML
6]document which will serve as the table of contents to the chain. The filename of the page you
7select appears in the field to the right of the button.
Setting the link text
s skip down now to the three lower text fields, labeled
Return to TOC Text, Previous
Page Text, Next Page Text.
> The text you type in these fields will be used as the colored
6^underlined text which links to the table of contents page, the previous page in the chain, and
 the next page in the chain. The
Courier
9 and tags with a URL link reference will automatically be
61wrapped around the text you type in these fields.
6Separating the links and selecting where to place them
Just above these fields is the
    Delimiter
)35 field. The text you type into this field is inserted
6Vbetween the links to separate them from one another when they are placed on your page.
&Finally, there is a popup menu titled
Append
+which controls where on each page the links
6Qare placed. See the description of the identical popup menu in the Appender wheel
"instructions for more information.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Lucida Bright
The Results
]How does this all come together? If you keep the default settings, as they are illustrated in
6*the screen shot above, and then click the
Link Pages
);* button, the following text will be placed
6/at the end of every one of your HTML documents:
Previous Page
Contents
    Next Page
Previous Page
 will be linked to the previous page in the chain,
Contents
 will be linked to
the page you selected with the
Choose Contents Page...
' button, and
Next Page
 will be linked
6Zto the next page in the chain. All three links are separated by
 as specified in the
    Delimiter
)4T field. Each page will contain these links and you will be able to move from page to
6Opage
forward or backward or up to the contents page
just by clicking the links.
 If you don
t use a Contents page
^If you do not use a Contents page, the links will be identical except that the
Contents
 link
will be missing. The
Choose Contents Page...
 button and the
 Return to TOC Page
 text field
will both be disabled.
You can use pictures too
YThe easiest way to use this wheel is to use hypertext for your links, as described above.
6]However, there is nothing to prevent you from using inlined images for the previous, contents
and next page links.
[Create your image files of a left-pointing arrow, a right-pointing arrow and an up-pointing
6Yarrow for the contents page. Place these images in the same folder that contains the HTML
^documents in the chain you are creating. Then in the link text fields, instead of typing
)Page
 (or whatever), type something like
Courier
<img src="next.gif">
 (or whatever).
?XYou may have to play with the pathnames a bit and you
ll probably want to delete all the
text from the
)S    Delimiter
)4? field. But experiment a little and you can easily add handsome
68buttons to your pages as easily as boring old hypertext.
Updating the links
\The first time you add sequential links to a page, the links are placed at whatever location
you specify with the
Append
),8 popup menu. The links are wrapped in the non-displaying
comment tags
<!--linkers-->
and
<!--end of linkers-->
?RThe next time you run the Sequential Linker on the same pages, something very cool
happens. The wheel ignores the
Append
),* popup menu and looks for the comment tags
6`instead. The wheel then throws out the old links, and inserts the new links in their place. This
Zmakes it very easy for you to maintain your pages and re-order them without worrying about
"deleting the obsolete links first.
* See Appendix for more about comment tags.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
StretchList
Lucida Bright
What are StretchLists
FStretchLists
 are a Web interface element designed by Matterform Media
. The StretchList
6Lwheel is a tool designed to help you create StretchLists quickly and easily.
WA StretchList is a way of condensing a long page of information into a simple, overview
6Wwhich can be taken in at a glance, and expanded at will. An illustration will make this
clearer
YFollowing is
 page of information. It contains some introductory information at the
6Xbeginning, and some closing information at the end. In between, it contains some natural
Zsections, which we shall call
elements,
 and which are named and formatted on the page as
8large bold text. A Web designer might tag them with the
Courier
" tag. Each of these Element titles
60precedes a paragraph or two of descriptive text.
+l)CGeneral introductory information. General introductory information.
CGeneral introductory information. General introductory information.
    Element 1
FText about element 1. Text about element 1. Text about element 1. Text
Gabout element 1. Text about element 1. Text about element 1. Text about
Aelement 1. Text about element 1. Text about element 1. Text about
6element 1. Text about element 1. Text about element 1.
    Element 2
FText about element 2. Text about element 2. Text about element 2. Text
Gabout element 2. Text about element 2. Text about element 2. Text about
Aelement 2. Text about element 2. Text about element 2. Text about
element 2.
    Element 3
FText about element 3. Text about element 3. Text about element 3. Text
Gabout element 3. Text about element 3. Text about element 3. Text about
Aelement 3. Text about element 3. Text about element 3. Text about
Aelement 3. Text about element 3. Text about element 3. Text about
6element 3. Text about element 3. Text about element 3.
IGeneral closing information. General closing information. General closing
Finformation. General closing information. General closing information.
General closing information.
?ZThe goal is to reduce this page to an overview. The overview should not require scrolling,
6:and should be easily expandable into the complete version.
UWhen we run the StretchList wheel on the source page, we receive a new condensed page
which looks like this:
I StretchLists and their name are inspired by Ted Nelson
s description of
StretchText.
):     For more
6(information see Nelson
s excellent book
Dream Machines.
)T- This is perhaps the first book of hypermedia
theory, published in the 1970s.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Lucida Bright
CGeneral introductory information. General introductory information.
CGeneral introductory information. General introductory information.
    Element 1
    Element 2
    Element 3
IGeneral closing information. General closing information. General closing
Finformation. General closing information. General closing information.
General closing information.
?ZThe introductory and closing information as well as the three element titles are retained,
6_but all the descriptive text is gone. Additionally, each element title is now a hypertext link,
and the small
)W'graphics have been automatically added.
?]This overview is a StretchList and functions in a fashion similar to the expanding folders of
6WSystem 7 on the Macintosh. By clicking on
Element 1,
 we can change the display to the
following:
+l)CGeneral introductory information. General introductory information.
CGeneral introductory information. General introductory information.
    Element 1
>Text about element 1. Text about element 1. Text about element
91. Text about element 1. Text about element 1. Text about
;element 1. Text about element 1. Text about element 1. Text
<about element 1. Text about element 1. Text about element 1.
Text about element 1.
    Element 2
    Element 3
IGeneral closing information. General closing information. General closing
Finformation. General closing information. General closing information.
General closing information.
?>The triangle to the left of
Element 1
 turns and points down
Element 1
 becomes bold
6Wfaced. And the descriptive text appears below the title and indented about a half-inch.
\Notice the continuity which this StretchList affords and which is unusual for hypertext. The
6aother two element titles are still on the page. Our place in the order of the information is very
Hclear. Even the introductory and closing information is still before us.
3If we click
Element 2,
 the display changes again:
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Lucida Bright
CGeneral introductory information. General introductory information.
CGeneral introductory information. General introductory information.
    Element 1
    Element 2
>Text about element 2. Text about element 2. Text about element
92. Text about element 2. Text about element 2. Text about
;element 2. Text about element 2. Text about element 2. Text
&about element 2. Text about element 2.
    Element 3
IGeneral closing information. General closing information. General closing
Finformation. General closing information. General closing information.
General closing information.
Element 1
 automatically re-closes and
Element 2
 expands. The other element titles are
condensed but still available.
XAt this point we could click
Element 3
 to expand it. Or we could click
Element 2
6 completely re-condense the page:
+l)CGeneral introductory information. General introductory information.
CGeneral introductory information. General introductory information.
    Element 1
    Element 2
    Element 3
IGeneral closing information. General closing information. General closing
Finformation. General closing information. General closing information.
General closing information.
?4That is the basic operation of a StretchList. It is
continuous
 hypertext as opposed to
discrete
hypertext.
Discrete
)*I hypertext is the kind that jumps the reader around from page to page and
6Wshows no obvious connection with other pages other than the underlined hypertext links.
Continuous
)<S hypertext maintains the continuity of a single view, but alters it slightly. It is
6@much easier to keep from getting lost with continuous hypertext.
 How StretchLists work on the Web
SThe Web has no provision for continuous hypertext. Therefore, we must trick it into
6Asimulating continuous hypertext by using only discrete hypertext.
WWe do this by taking the single source page, and breaking it into a number of different
6\StretchList pages. There is a page for the completely condensed version, and a page for each
^of the expanded elements. The element titles link cleverly from page to page. In this way, the
Wappearance of continuity is maintained, even though we are actually moving from page to
discrete page.
aIf this sounds like a lot of work, it is. But the beauty of the StretchList wheel is that it does
all the work for you.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Lucida Bright
Sample StretchLists
,You can try out some sample StretchLists at:
Courier
5http://www.matterform.com/legend/stretchexamples.html
Formatting the source file
_To create a StretchList, you start from a single source file and insert tags that will instruct
6Jthe StretchList wheel how to break your source file up into a StretchList.
[The element titles are the most important items to identify in the source file. You need to
6`wrap the element titles in a distinctive tag. The best thing to do is to wrap the element titles
in a
 and
</h3>
 tag. However, if you use the
# tag elsewhere in the document, you
6!will need to use a different tag.
ZIf you want to include introductory and closing information (text, graphics or buttons) at
6]the top and bottom of every page of your StretchList, you will need to identify that as well.
WYou should mark this information with a non-displaying comment tag at the beginning and
4end of the information. You could use the following:
<!--header-->
0at the beginning of the introductory information
<!--end of header-->
*at the end of the introductory information
<!--footer-->
+at the beginning of the closing information
<!--end of footer-->
%at the end of the closing information
?XYou can use whatever tags you wish to mark the elements, header and footer but they must
6\be unique tags. You will enter these same tags into the StretchList wheel before you run it.
+h 7Sample HTML code of a formatted StretchList source file
<!--header-->
6General introductory information. General introductory
6information. General introductory information. General
introductory information.
<!--end of header-->
<h3>Element 1</h3>
6Text about element 1. Text about element 1. Text about
;element 1. Text about element 1. Text about element 1. Text
&about element 1. Text about element 1.
<h3>Element 2</h3>
6Text about element 2. Text about element 2. Text about
;element 2. Text about element 2. Text about element 2. Text
<about element 2. Text about element 2. Text about element 2.
Text about element 2.
<h3>Element 3</h3>
6Text about element 3. Text about element 3. Text about
;element 3. Text about element 3. Text about element 3. Text
&about element 3. Text about element 3.
<!--footer-->
9General closing information. General closing information.
9General closing information. General closing information.
<!--end of footer-->
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Lucida Bright
Loading the source file
[The StretchList wheel is somewhat unusual in that it works on only one file at a time. Drag
your source file, and
; your single source file, onto the Grinder icon to load it.
Watch your fingers
^Of course you have a backup of this source file, right? Of course you realize that even if all
6Zgoes well, the file is going to be unrecognizably altered and permanently changed? And you
Xrealize that if you make one little slip-up, your file will possibly even be irrevocably
#annihilated? Please work on a copy.
Setting the icon locations
JJP    JR
@%    JJB    JR
JJP    )!JR
@%    JJB
!The Grinder comes with the small
 icons. They
6;are located in a folder called
StretchList icons
 which in
;turn is located inside the Grinder Tools folder. Copy these
2icons into an appropriate folder in your Web site.
9Then use the buttons at the top of the screen to show the
62Grinder where the condensed and expanded icons are
:located. You will be given a standard open dialog box with
3which you can select the location of each icon. The
=locations will appear in the text fields to the right of each
;button. Don
t worry if the address appears cut off
s all
there.
Element tag
In the field
)A%Format for the title of each element,
) type in the tag you used to identify the
6<element titles when you set up the source file (for example
Courier
). You only need to type in
6Wthe starting tag. The wheel will automatically generate the appropriate ending tag (for
example
</h3>
Header and Footer
In the
Header Tags
)HB fields, type the non-displaying comment tags you used to mark the
6Xbeginning and end of the header information when you set up the source file (for example
<!--header-->
  and
<!--end of header-->
In the
Footer Tags
)DB fields, type the non-displaying comment tags you used to mark the
6Ybeginning and end of the footer information when you set up the source file (for example
-footer-->
  and
<!--end of footer-->
Run the wheel
ZThat
s all the settings you need to make. Have you got a backup of the source document? If
so, go ahead and run the wheel.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Lucida Bright
The new files
2The StretchList wheel makes the following changes:
WCondenses the source file completely (this is why it is so important to make a backup).
Installs the
icons.
PCreates a new file for each element. The new files are named the same as the now
U3altered source file with the addition of a numeral.
4Installs all the appropriate links in all the files.
?^So if you start with a source file called
list.html
 containing three elements,  you will now
have the following files:
Courier
+p     list.html
)M3now condensed and the first page of the StretchList
list.html copy
)n&the backup you made of the source file
list1.html
list2.html
)T3the three expanded element pages in the StretchList
list3.html
Changing the StretchList
ZThe best way to change a StretchList is to go back to your untouched source file, make the
changes
there,
K and then make another copy and run it through the StretchList wheel again.
About those triangle icons
^Notice that the triangle icons are not themselves linked. Clicking on them has no effect. This
6]is because most Web browsers put a blue frame around linked graphics. Since this is ugly, the
<StretchList wheel does not link the triangle icons. Oh well.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Preferences
Lucida Bright
UGrinder preferences are available in the main Grinder window. This is the window that
6Yappears when you double-click on the Grinder icon. You can open the Grinder window at any
time by choosing
Preferences
 from the Tools menu.
@c038
)JBH
)JBH
)JBH
)JBH
)JBH
)JBH
)JBH
)JBH
)JBH
)JBH
)JBH
)JBH
)JBH
0332d*
0330p
3    03?303308*
03030330
3    0313 332L*
?7The window is dominated by a large scrolling field that
6:holds the list of documents that were last loaded into the
4Grinder. You can change the contents of this list by
6dragging a different set of documents onto the Grinder
7icon. You can also change it by hand. This is sometimes
7useful when using the Sequential Linker wheel, when the
5order in which the documents are listed is essential.
:There are two checkboxes below the scrolling field. If you
check
)$$Clear field before loading new docs,
 the Grinder
will completely
replace
 the contents of the documents
67field with the names of the new documents you drag onto
3the Grinder icon. If you uncheck this box, dragging
 documents onto the Grinder will
 the old documents
* the new documents to the end of the list.
If you check
Chime when done grinding,
2 the Grinder will let you know when it is finished
6Floading or grinding documents. Uncheck this box if you hate the chime.
[At the very bottom of the window is a text field which contains the pathname to the Grinder
6YTools folder. If you keep the Grinder Tools folder in the same folder as the HTML Grinder
`application, and do not rename it, the Grinder will always be able to keep this field up-to-date
\automatically. If you must move or rename the folder, the Grinder will ask you to locate the
]folder the next time it is opened and will store the new pathname in this field. You can also
'set a new pathname by hand by clicking
Choose Tool Folder...
Click
About
)"O to see the Grinder splash screen along with contact information for Matterform
64Media. Clicking this button is the same as choosing
About the HTML Grinder...
 from the
menu. Click
L to see a brief help document for using the Grinder. Clicking this button is
the same as clicking the
5 button in the lower-left corner of any wheel window.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Appendix
Demo Mode and Serial Numbers
Lucida Bright
WAll the Grinder wheels except the Find and Replace wheel ship in Demo Mode. This allows
6[you to try the wheels out for a few weeks. After that time, the wheels expire and require a
&serial number to continue functioning.
YWhen you open a wheel in Demo Mode, it displays a dialog box that gives you the following
three options:
f`ff0
f`ff0
&`fb1
3132c
>`f>fg
33#0&ba
3132c
    Register.
)0& Click this button if you already have
U-received your serial number. You will then be
4prompted to enter your number. Be sure to type it in
exactly
)%- as you received it. Once you type in a valid
U7serial number, you will not be bothered with the serial
number dialog box again.
Demo Mode.
)FI Click this if you don
t have a serial number yet and you want to try the
UWwheel out in Demo Mode. If you receive a serial number later on, you can type it in the
next time you open this wheel.
Serial # ?
)7I Click this for a little more information about serial numbers and how to
purchase them.
?>When Demo Mode expires on any wheel, your only option will be
    Register.
 If you do not
6Wtype in a valid serial number, the wheel will close and you will not be able to use it.
YEach wheel requires its own serial number. This allows you to purchase serial numbers for
6^only the wheels you want to keep. There is a discount for purchasing all the serial numbers at
once. See
How to Contact Us
)g> on page 2 for more information about ordering serial numbers.
?[Do not open any of the wheels until you are ready to evaluate it. If you open a wheel for a
6Zquick look, then close it and don
t come back to it for a month, you will find that it has
[expired before you even had a chance to review it. Downloading a new wheel will not help
will be expired too.
XWhen you receive your serial numbers, install them right away. They will expire in a few
6(days if you do not use them soon enough.
YBe sure to keep a copy of the serial numbers you receive. You will need them again if you
6_have to reinstall the Grinder, or if you move the Grinder application to a different Macintosh.
t drag documents onto the Grinder icon
TSome people have problems dragging documents onto the Grinder icon. The Grinder just
6Zwon
t highlight when a document is dragged onto it. This usually happens immediately after
3downloading and installing the Grinder application.
<If this happens to you, you can solve the problem easily by
rebuilding your desktop file.
6PSimply restart your Macintosh, and hold down the command and option keys on your
Zkeyboard. Keep holding these keys down as your Macintosh restarts until you see the dialog
[box asking if you want to rebuild your desktop file. Now you can release the keys and click
S For the next minute or so, the computer will rebuild the desktop file, and when it
6Nfinishes, you should have no trouble dragging documents onto the Grinder icon.
(Tricks for selecting icons in the Finder
^The Grinder requires that you all the files that you want to grind onto the Grinder icon. This
6`is easy enough when you
re just grinding five or ten files at a time. You can click on the first
=file, then shift-click on the remaining files to select them.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Lucida Bright
?WHowever, when you start grinding dozens, or even hundreds of files at a time, there are
6Hsome tricks you
ll want to know about for selecting icons in the Finder.
3Selecting files from more than one folder at a time
ZQuite often you need to grind documents from different folders. Fortunately, the Macintosh
6Callows you to select files from different folders at the same time.
RII)JA$I
RIy'K
RIA)J
RII)JA$I
9    $I$
)1$IH$
)!$IH$
&1$I$
r    "I
@To do this, you must open the window that contains the different
folders, and switch to a
list view.
 Just choose
By Name, By Date,
 or some
6Hother non-icon view from the View menu. The window will switch to a list
view.
%All the folder have little triangles
  to the left of them. Click on a
triangle to turn it down
1 and display in outline view the contents of that
folder.
HBy expanding folders, you can select files from different folders at the
6Isame time. Then you can drag all the files at once onto the Grinder icon.
CYou can also expand folders by clicking once on the folder icon and
6    pressing
Symbol
8 . You can also collapse folders by clicking once on the
folder icon and pressing
Filtering your selections
E>F '
JPicking just the HTML documents out of all your files can be very tedious.
You can use the Finder
Find...
)"/ command to filter your selections and get just
the documents you want.
GSay you have a folder full of HTML documents you want to grind. But the
6LHTML documents are mixed in with a bunch of GIF files that you don
t want to
(grind. You can open the folder and type
A for
Select All.
 Then choose
from the File menu or type
(: If you are using System 7.5, hold down
the shift key while choosing
. in order to get the older version of the Find
dialog box.)
EThe Find dialog box appears. The first thing you want to do is click
More Choices,
 so that
6;the dialog box changes to something like that at the right.
330#33
&ffd`1
ff``1
f&bd`1
332fd
0#32f`
330fp
330~8
0330~`
0330``
332bL
1332b`
Now change the
Search
 popup menu in the
6!middle of the dialog box to read
the selected
items.
)!' This will apply the search only to the
6.icons you have already selected in the Finder.
+Now you can use the upper popup to set up a
6/search. You might want to find and select items
.whose name contains
.html
. Or you could find
$and select items whose kind contains
SimpleText
BBEdit
 or whatever. You can even search for files with a certain label (color)
,or which were modified after a certain date.
JIJL    "
JIJH    "
E>F '
(When you make your settings, just click
Find.
 After a moment, the Find
6Nprogram will filter your selection down to just the appropriate files. You can
Hperform another filter with the Find command if necessary. When you have
9just the files you want, drag them onto the Grinder icon.
    Helvetica
)HTML Grinder
 http://www.matterform.com/
Page
Comment Tags
Lucida Bright
UA comment is a bit of text which can be inserted into an HTML document but which does
6@not display when the HTML document is loaded into a Web browser.
QYou can
comment
 any piece of text just by surrounding it with the standard HTML
6Tcomment tags. To insert the phrase
footer
 as a non-displaying comment in your HTML
document, just type it as:
Courier
<!--footer-->
?UYou will be able to see the comment when you open the HTML document in a text editor.
6XBut when the document is loaded into a Web browser, the comment will be ignored and will
not appear.
XYou can use the comment tag to make notes to yourself in your HTML code. Several Grinder
wheels
such as
)b#Replace Tagged Text, Index Builder,
 and
Sequential Linker
also use
6Ccomment tags to embed important information in your HTML documents.
Note:
Q Do not use comments to insert secret information into your HTML documents. While
6Xthe comments do not display in Web browsers, they usually do show up when a user chooses
View Source
 from any of your pages.
&" 'W
`00p`
xTP`P
`00p`
KE42I
!?7$3<
`00p`
#(,/1235
!0%4O
`00p`
*/!'"
xTP`P
`    >0X
0`<    >0X
*&,'(
&" 'W
KE42I
!?7$3<
#(,/1235
!0%4O
*/!'"
*&,'(
@ x @
neel encounters an image tag whic    temp.0001
nd that the width and height parameters are functional only in the Netscape browser (but they are not less valuable for that). Fin
Michael Herrick
Matterform Media
Microsoft Word 5.1a
ffffff
ffff33
ff33ff
ff3333
33ffff
33ff33
+3333
3333ff
333333
riwwwwww
MeUUUUUU
TMDDDDDD
th""""""
~~~~~~
}}}}}}
||||||
{{{{{{
zzzzzz
yyyyyy
xxxxxx
wwwwww
vvvvvv
uuuuuu
tttttt
ssssss
rrrrrr
qqqqqq
pppppp
oooooo
nnnnnn
mmmmmm
llllll
kkkkkk
jjjjjj
iiiiii
hhhhhh
gggggg
ffffff
eeeeee
dddddd
cccccc
bbbbbb
aaaaaa
``````
______
^^^^^^
]]]]]]
\\\\\\
[[[[[[
ZZZZZZ
YYYYYY
XXXXXX
WWWWWW
VVVVVV
UUUUUU
TTTTTT
SSSSSS
RRRRRR
QQQQQQ
PPPPPP
OOOOOO
NNNNNN
MMMMMM
LLLLLL
KKKKKK
JJJJJJ
IIIIII
HHHHHH
GGGGGG
FFFFFF
EEEEEE
DDDDDD
CCCCCC
BBBBBB
AAAAAA
@@@@@@
??????
>>>>>>
======
<<<<<<
;;;;;;
::::::
999999
888888
777777
666666
555555
444444
333333
222222
111111
000000
//////
......
------
,,,,,,
++++++
******
))))))
((((((
''''''
&&&&&&
%%%%%%
$$$$$$
######
""""""
!!!!!!


Chicago
    Helvetica
Courier
Symbol
Lucida Bright
zPREC
"clut
.FMTS
:FNMS